v10.28.0

Compare Source

Important Changes

• feat(core): Make matcher parameter optional in makeMultiplexedTransport (#​10798)

The matcher parameter in makeMultiplexedTransport is now optional with a sensible default. This makes it much easier to use the multiplexed transport for sending events to multiple DSNs based on runtime configuration.

Before:

import { makeFetchTransport, makeMultiplexedTransport } from '@​sentry/browser';

const EXTRA_KEY = 'ROUTE_TO';

const transport = makeMultiplexedTransport(makeFetchTransport, args => {
  const event = args.getEvent();
  if (event?.extra?.[EXTRA_KEY] && Array.isArray(event.extra[EXTRA_KEY])) {
    return event.extra[EXTRA_KEY];
  }
  return [];
});

Sentry.init({
  transport,
  // ... other options
});

// Capture events with routing info
Sentry.captureException(error, {
  extra: {
    [EXTRA_KEY]: [
      { dsn: 'https://key1@​sentry.io/project1', release: 'v1.0.0' },
      { dsn: 'https://key2@​sentry.io/project2' },
    ],
  },
});

After:

import { makeFetchTransport, makeMultiplexedTransport, MULTIPLEXED_TRANSPORT_EXTRA_KEY } from '@​sentry/browser';

// Just pass the transport generator - the default matcher handles the rest!
Sentry.init({
  transport: makeMultiplexedTransport(makeFetchTransport),
  // ... other options
});

// Capture events with routing info using the exported constant
Sentry.captureException(error, {
  extra: {
    [MULTIPLEXED_TRANSPORT_EXTRA_KEY]: [
      { dsn: 'https://key1@​sentry.io/project1', release: 'v1.0.0' },
      { dsn: 'https://key2@​sentry.io/project2' },
    ],
  },
});

The default matcher looks for routing information in event.extra[MULTIPLEXED_TRANSPORT_EXTRA_KEY]. You can still provide a custom matcher function for advanced use cases.

• feat(nextjs): Support cacheComponents on turbopack (#​18304)

This release adds support for cacheComponents on turbopack builds. We are working on adding support for this feature in webpack builds as well.

Other Changes

• feat: Publish AWS Lambda Layer for Node 24 (#​18327)
• feat(browser): Expose langchain instrumentation (#​18342)
• feat(browser): Expose langgraph instrumentation (#​18345)
• feat(cloudflare): Allow specifying a custom fetch in Cloudflare transport options (#​18335)
• feat(core): Add isolateTrace option to Sentry.withMonitor() (#​18079)
• feat(deps): bump @​sentry/webpack-plugin from 4.3.0 to 4.6.1 (#​18272)
• feat(nextjs): Add cloudflare waitUntil detection (#​18336)
• feat(node): Add LangChain v1 support (#​18306)
• feat(remix): Add parameterized transaction naming for routes (#​17951)
• fix(cloudflare): Keep http root span alive until streaming responses are consumed (#​18087)
• fix(cloudflare): Wait for async events to finish (#​18334)
• fix(core): continueTrace doesn't propagate given trace ID if active span exists (#​18328)
• fix(node-core): Handle custom scope in log messages without parameters (#​18322)
• fix(opentelemetry): Ensure Sentry spans don't leak when tracing is disabled (#​18337)
• fix(react-router): Use underscores in trace origin values (#​18351)
• chore(tanstackstart-react): Export custom inits from tanstackstart-react (#​18369)
• chore(tanstackstart-react)!: Remove empty placeholder implementations (#​18338)

Bundle size 📦

v10.27.0

Compare Source

Important Changes

• feat(deps): Bump OpenTelemetry (#​18239)

  • Bump @​opentelemetry/context-async-hooks from ^2.1.0 to ^2.2.0
  • Bump @​opentelemetry/core from ^2.1.0 to ^2.2.0
  • Bump @​opentelemetry/resources from ^2.1.0 to ^2.2.0
  • Bump @​opentelemetry/sdk-trace-base from ^2.1.0 to ^2.2.0
  • Bump @​opentelemetry/sdk-trace-node from ^2.1.0 to ^2.2.0
  • Bump @​opentelemetry/instrumentation from 0.204.0 to 0.208.0
  • Bump @​opentelemetry/instrumentation-amqplib from 0.51.0 to 0.55.0
  • Bump @​opentelemetry/instrumentation-aws-sdk from 0.59.0 to 0.64.0
  • Bump @​opentelemetry/instrumentation-connect from 0.48.0 to 0.52.0
  • Bump @​opentelemetry/instrumentation-dataloader from 0.22.0 to 0.26.0
  • Bump @​opentelemetry/instrumentation-express from 0.53.0 to 0.57.0
  • Bump @​opentelemetry/instrumentation-fs from 0.24.0 to 0.28.0
  • Bump @​opentelemetry/instrumentation-generic-pool from 0.48.0 to 0.52.0
  • Bump @​opentelemetry/instrumentation-graphql from 0.52.0 to 0.56.0
  • Bump @​opentelemetry/instrumentation-hapi from 0.51.0 to 0.55.0
  • Bump @​opentelemetry/instrumentation-http from 0.204.0 to 0.208.0
  • Bump @​opentelemetry/instrumentation-ioredis from 0.52.0 to 0.56.0
  • Bump @​opentelemetry/instrumentation-kafkajs from 0.14.0 to 0.18.0
  • Bump @​opentelemetry/instrumentation-knex from 0.49.0 to 0.53.0
  • Bump @​opentelemetry/instrumentation-koa from 0.52.0 to 0.57.0
  • Bump @​opentelemetry/instrumentation-lru-memoizer from 0.49.0 to 0.53.0
  • Bump @​opentelemetry/instrumentation-mongodb from 0.57.0 to 0.61.0
  • Bump @​opentelemetry/instrumentation-mongoose from 0.51.0 to 0.55.0
  • Bump @​opentelemetry/instrumentation-mysql from 0.50.0 to 0.54.0
  • Bump @​opentelemetry/instrumentation-mysql2 from 0.51.0 to 0.55.0
  • Bump @​opentelemetry/instrumentation-nestjs-core from 0.50.0 to 0.55.0
  • Bump @​opentelemetry/instrumentation-pg from 0.57.0 to 0.61.0
  • Bump @​opentelemetry/instrumentation-redis from 0.53.0 to 0.57.0
  • Bump @​opentelemetry/instrumentation-tedious from 0.23.0 to 0.27.0
  • Bump @​opentelemetry/instrumentation-undici from 0.15.0 to 0.19.0
  • Bump @​prisma/instrumentation from 6.15.0 to 6.19.0

• feat(browserprofiling): Add manual mode and deprecate old profiling (#​18189)

  Adds the manual lifecycle mode for UI profiling (the default mode), allowing profiles to be captured manually with Sentry.uiProfiler.startProfiler() and Sentry.uiProfiler.stopProfiler().
  The previous transaction-based profiling is with profilesSampleRate is now deprecated in favor of the new UI Profiling with profileSessionSampleRate.

Other Changes

• feat(core): Add gibibyte and pebibyte to InformationUnit type (#​18241)
• feat(core): Add scope attribute APIs (#​18165)
• feat(core): Re-add _experiments.enableLogs option (#​18299)
• feat(core): Use maxValueLength on error messages (#​18301)
• feat(deps): bump @​sentry/bundler-plugin-core from 4.3.0 to 4.6.1 (#​18273)
• feat(deps): bump @​sentry/cli from 2.56.0 to 2.58.2 (#​18271)
• feat(node): Add tracing support for AzureOpenAI (#​18281)
• feat(node): Fix local variables capturing for out-of-app frames (#​18245)
• fix(core): Add a PromiseBuffer for incoming events on the client (#​18120)
• fix(core): Always redact content of sensitive headers regardless of sendDefaultPii (#​18311)
• fix(metrics): Update return type of beforeSendMetric (#​18261)
• fix(nextjs): universal random tunnel path support (#​18257)
• ref(react): Add more guarding against wildcards in lazy route transactions (#​18155)
• chore(deps): bump glob from 11.0.1 to 11.1.0 in /packages/react-router (#​18243)

Work in this release was contributed by @​bignoncedric and @​adam-kov. Thank you for your contributions!

Bundle size 📦

v10.26.0

Compare Source

Important Changes

• feat(core): Instrument LangGraph Agent (#​18114)

Adds support for instrumenting LangGraph StateGraph operations in Node. The LangGraph integration can be configured as follows:

Sentry.init({
  dsn: '__DSN__',
  sendDefaultPii: false, // Even with PII disabled globally
  integrations: [
    Sentry.langGraphIntegration({
      recordInputs: true, // Force recording input messages
      recordOutputs: true, // Force recording response text
    }),
  ],
});

• feat(cloudflare/vercel-edge): Add manual instrumentation for LangGraph (#​18112)

Instrumentation for LangGraph in Cloudflare Workers and Vercel Edge environments is supported by manually calling instrumentLangGraph:

import * as Sentry from '@​sentry/cloudflare'; // or '@​sentry/vercel-edge'
import { StateGraph, START, END, MessagesAnnotation } from '@​langchain/langgraph';

// Create and instrument the graph
const graph = new StateGraph(MessagesAnnotation)
  .addNode('agent', agentFn)
  .addEdge(START, 'agent')
  .addEdge('agent', END);

Sentry.instrumentLangGraph(graph, {
  recordInputs: true,
  recordOutputs: true,
});

const compiled = graph.compile({ name: 'weather_assistant' });

await compiled.invoke({
  messages: [{ role: 'user', content: 'What is the weather in SF?' }],
});

• feat(node): Add OpenAI SDK v6 support (#​18244)

Other Changes

• feat(core): Support OpenAI embeddings API (#​18224)
• feat(browser-utils): bump web-vitals to 5.1.0 (#​18091)
• feat(core): Support truncation for LangChain integration request messages (#​18157)
• feat(metrics): Add default server.address attribute on server runtimes (#​18242)
• feat(nextjs): Add URL to server-side transaction events (#​18230)
• feat(node-core): Add mechanism to prevent wrapping ai providers multiple times(#​17972)
• feat(replay): Bump limit for minReplayDuration (#​18190)
• fix(browser): Add ok status to successful idleSpans (#​18139)
• fix(core): Check fetch support with data URL (#​18225)
• fix(core): Decrease number of Sentry stack frames for messages from captureConsoleIntegration (#​18096)
• fix(core): Emit processed metric (#​18222)
• fix(core): Ensure logs past MAX_LOG_BUFFER_SIZE are not swallowed (#​18207)
• fix(core): Ensure metrics past MAX_METRIC_BUFFER_SIZE are not swallowed (#​18212)
• fix(core): Fix logs and metrics flush timeout starvation with continuous logging (#​18211)
• fix(core): Flatten gen_ai.request.available_tools in google-genai (#​18194)
• fix(core): Stringify available tools sent from vercelai (#​18197)
• fix(core/vue): Detect and skip normalizing Vue VNode objects with high normalizeDepth (#​18206)
• fix(nextjs): Avoid wrapping middleware files when in standalone mode (#​18172)
• fix(nextjs): Drop meta trace tags if rendered page is ISR (#​18192)
• fix(nextjs): Respect PORT variable for dev error symbolication (#​18227)
• fix(nextjs): use LRU map instead of map for ISR route cache (#​18234)
• fix(node): tracingChannel export missing in older node versions (#​18191)
• fix(node): Fix Spotlight configuration precedence to match specification (#​18195)
• fix(react): Prevent navigation span leaks for consecutive navigations (#​18098)
• ref(react-router): Deprecate ErrorBoundary exports (#​18208)

v10.25.0

Compare Source

v10.24.0

Compare Source

Important Changes

• feat(metrics): Add top level option enableMetrics and beforeSendMetric (#​18088)

  This PR moves enableMetrics and beforeSendMetric out of the _experiments options.
  The metrics feature will now be enabled by default (none of our integrations will auto-emit metrics as of now), but you can disable sending metrics via enableMetrics: false.
  Metric options within _experiments got deprecated but will still work as of now, they will be removed with the next major version of our SDKs.

Other Changes

• feat(aws): Add SENTRY_LAYER_EXTENSION to configure using the lambda layer extension via env variables (#​18101)
• feat(core): Include all exception object keys instead of truncating (#​18044)
• feat(metrics)!: Update types (#​17907)
• feat(replay): ignore background-image when blockAllMedia is enabled (#​18019)
• fix(nextjs): Delete css map files (#​18131)
• fix(nextjs): Stop accessing sync props in template (#​18113)

Bundle size 📦

v10.23.0

Compare Source

• feat(core): Send user-agent header with envelope requests in server SDKs (#​17929)
• feat(browser): Limit transport buffer size (#​18046)
• feat(core): Remove default value of maxValueLength: 250 (#​18043)
• feat(react-router): Align options with shared build time options type (#​18014)
• fix(browser-utils): cache element names for INP (#​18052)
• fix(browser): Capture unhandled rejection errors for web worker integration (#​18054)
• fix(cloudflare): Ensure types for cloudflare handlers (#​18064)
• fix(nextjs): Update proxy template wrapping (#​18086)
• fix(nuxt): Added top-level fallback exports (#​18083)
• fix(nuxt): check for H3 error cause before re-capturing (#​18035)
• fix(replay): Linked errors not resetting session id (#​17854)
• fix(tracemetrics): Bump metrics buffer to 1k (#​18039)
• fix(vue): Make options parameter optional on attachErrorHandler (#​18072)
• ref(core): Set span status internal_error instead of unknown_error (#​17909)

Work in this release was contributed by @​hanseo0507. Thank you for your contribution!

Bundle size 📦

v10.22.0

Compare Source

Important Changes

• feat(node): Instrument cloud functions for firebase v2 (#​17952)

  We added instrumentation for Cloud Functions for Firebase v2, enabling automatic performance tracking and error monitoring. This will be added automatically if you have enabled tracing.

• feat(core): Instrument LangChain AI (#​17955)

  Instrumentation was added for LangChain AI operations. You can configure what is recorded like this:

  Sentry.init({
    integrations: [
      Sentry.langChainIntegration({
        recordInputs: true, // Record prompts/messages
        recordOutputs: true, // Record responses
      }),
    ],
  });

Other Changes

• feat(cloudflare,vercel-edge): Add support for LangChain instrumentation (#​17986)
• feat: Align sentry origin with documentation (#​17998)
• feat(core): Truncate request messages in AI integrations (#​17921)
• feat(nextjs): Support node runtime on proxy files (#​17995)
• feat(node): Pass requestHook and responseHook option to OTel (#​17996)
• fix(core): Fix wrong async types when instrumenting anthropic's stream api (#​18007)
• fix(nextjs): Remove usage of chalk to avoid runtime errors (#​18010)
• fix(node): Pino capture serialized err (#​17999)
• fix(node): Pino child loggers (#​17934)
• fix(react): Don't trim index route / when getting pathname (#​17985)
• fix(react): Patch spanEnd for potentially cancelled lazy-route transactions (#​17962)

Bundle size 📦

v10.21.0

Compare Source

Important Changes

• feat(browserProfiling): Add trace lifecycle mode for UI profiling (#​17619)

  Adds a new trace lifecycle mode for UI profiling, allowing profiles to be captured for the duration of a trace. A manual mode will be added in a future release.

• feat(nuxt): Instrument Database (#​17899)

  Adds instrumentation for Nuxt database operations, enabling better performance tracking of database queries.

• feat(nuxt): Instrument server cache API (#​17886)

  Adds instrumentation for Nuxt's server cache API, providing visibility into cache operations.

• feat(nuxt): Instrument storage API (#​17858)

  Adds instrumentation for Nuxt's storage API, enabling tracking of storage operations.

Other Changes

• feat(browser): Add onRequestSpanEnd hook to browser tracing integration (#​17884)
• feat(nextjs): Support Next.js proxy files (#​17926)
• feat(replay): Record outcome when event buffer size exceeded (#​17946)
• fix(cloudflare): copy execution context in durable objects and handlers (#​17786)
• fix(core): Fix and add missing cache attributes in Vercel AI (#​17982)
• fix(core): Improve uuid performance (#​17938)
• fix(ember): Use updated version for clean-css (#​17979)
• fix(nextjs): Do